home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / telecomm / misc / rsp37_1.lha / RShell-Protector.doc < prev    next >
Encoding:
Text File  |  1994-10-23  |  5.0 KB  |  122 lines
  1. RemoteShell-Protector.doc
  2.  
  3.  INTRODUCTION
  4. As a sysop or networking-fan you are lucky if the following never
  5. happened to you:
  6. Some Cosys logs in, enters the shell to search a file and
  7. accidentially starts a GUI-driven program that's not
  8. self-detaching. POOF! Your BBS hangs! If you are at home - fine.
  9. If you aren't, your system will be down for a long time.
  10. Ever tried the same thing with X-Windows? If you start a
  11. GUI-driven program from a local shell - no problem. If you try
  12. it via a telnet link (and don't specify any "-display"
  13. parameters) it just says "Can't open display!" and exits.
  14. This is what RShell-Protector achieves on the Amiga.
  15.  
  16.  REQUIREMENTS
  17. RShell-Protector makes use of environment variables and therefore
  18. requires OS2.04. 
  19.  
  20.  INSTALLATION/USAGE
  21. The "rshell-protector" executable is intended to be run as a
  22. background task in the user-startup script. The install-script
  23. included in this archive should perform all necessary changes for
  24. you. The program patches intuition.library and then hangs in the
  25. background, waiting for a Ctrl-C signal. If you ever want to
  26. remove the patches, just use "break <processnumber> c". No fancy
  27. (and illegal) patching routines are used so RShell-Protector will
  28. work fine with SaferPatches.
  29. To actually protect a shell, you have to set the local variable
  30. "RSHELL-PROTECTOR". E.g. in the shell-startup script use:
  31.  set RSHELL-PROTECTOR 1
  32. Programs started from this shell (and its childred which inherit
  33. local variables) will fail to open any window or screen. Using
  34. the "set" and "unset" commands you can switch between "protected"
  35. and "unprotected" while the shell is running.
  36. There might be programs which don't care if Intuition returns
  37. NULL on an OpenScreen()/OpenWindow() call. They will render into
  38. an invalid rastport and crash. The best place for such programs
  39. is your trashcan.
  40.  
  41.  CNET BBS INSTALLATION
  42. When running some network with remote-logins you will most likely
  43. have some kind of rlogin-startup script, which you don't have for
  44. the BBS shell in CNet. Let's change that:
  45. Load CNet's "bbstext" file into your favourite editor and move to
  46. line #632 where you will find a newshell-command and some options
  47. for the FIFO: handler. Just change the end of the line from
  48. "from S:shell-startup" to something like
  49. "from s:CNetShell-Startup" and save the file.
  50. Create a file called "CNetShell-Startup (or however you called
  51. it) in your s: directory. It sould contain at least:
  52.  execute s:shell-startup
  53.  set RSHELL-PROTECTOR 1
  54. and maybe some other tools/patches that you want to use from the
  55. BBS shell only. Now select "text/menu reload" from CNet's menu
  56. and you're done.
  57.  
  58.  INSTALLATION ON OTHER BBS-PROGRAMS
  59. Sorry, can't tell you much about this - you have to find out
  60. yourself. Using SnoopDos will help! For DLG the installation
  61. should be similar to CNet, AFAIK the command to call when opening
  62. a shell is also configurable through a textfile.
  63.  
  64.  TECHNICAL INFO/COMPATIBILITY
  65. RShell-Protector patches the following intuition-functions:
  66.  OpenScreen()
  67.  OpenWindow()
  68.  OpenScreenTagList()
  69.  OpenWindowTagList()
  70. On every call to these functions it checks for the environment
  71. variable called "RSHELL-PROTECTOR". If there is no such variable
  72. the original function is called. Otherwise an error-message is
  73. printed on stdout and zero returned, which means "failure" to the
  74. calling program.
  75. As the ones with good RKM-knowledge will have noticed, this
  76. method is not 100% system friendly. If a TASK (not a PROCESS)
  77. calls one of the above functions, there will be trouble. Only
  78. processes are allowed to call dos.library, tasks aren't. But no
  79. need to ban this patch from your HD forever! We know of only ONE
  80. task that ever calls OpenWindow(), which is the Fastlane's
  81. "z3scsi.device" - and this is only to display errors on very
  82. early system startup.
  83.  
  84. RShell-Protector has been tested on:
  85. A4000/040, OS3.0, 12MB RAM, Fastlane, Merlin
  86. A4000/030, OS3.0, 22MB RAM, GVP-II, Merlin, MFC-2, CNet/3
  87. A2000, A2630, OS3.1, 7MB RAM, Mastercard, MFC-2, CNet/3
  88. No 68030 or OS3.0+ specific features are used so it should also
  89. run on the 68000 and with OS2.04.
  90.  
  91.  BUGS
  92. Returncode is always 0, no matter if the patching succeeded or
  93. not. If this annoys you, fix it.
  94.  
  95.  COPYLEFT
  96. RShell-Protector is copylefted software. Do with it whatever you
  97. like. The sourcecode in asm is included so you can hack around
  98. with it - we used AsmOne V1.50 to write it. The only thing you
  99. must not do is redistribute hacked-up versions with our names in
  100. them - or thou shalt be marked a lamer forever!
  101. If you implement any improvements, please let us know. See below
  102. for addresses.
  103.  
  104.  AUTHORS
  105. If you can't find us on IRC, send comments, flames etc. to:
  106. Usenet:   hg6202@sun0.mni.fh-giessen.de
  107. AmigaNet: Lunkwill@39:176/208.0
  108.           Skywalker@39:176/208.3
  109.  
  110. Call these BBSs:
  111. Sweet Dreams - +49-6404-61539 (Line 1, ZyXEL 19k2, 24h)
  112.                +49-6404-65106 (Line 2, ZyXEL 16k8, 22-13h)
  113. Thunder Dome - +49-6408-3249  (Line 1, ZyXEL 19k2, 24h)
  114.                +49-6408-3779  (Line 2, ZyXEL 19k2, 22-13h)
  115.  
  116.  
  117.  HISTORY
  118. V37.1, 23-10-94, initial release
  119.  
  120.  FUTURE
  121. Maybe a WB emulation using RIP-term...? :^)
  122.